home *** CD-ROM | disk | FTP | other *** search
/ Aminet 5 / Aminet 5 - March 1995.iso / Aminet / comm / bbs / TACFl158.readme < prev    next >
Encoding:
Text File  |  1995-02-13  |  7.0 KB  |  183 lines
  1. Short:    Transamiga Filelist Creator V1.58
  2. Author:   s_supp@ira.uka.de
  3. Uploader: s_supp@ira.uka.de
  4. Type:     comm/bbs
  5.  
  6.  
  7.                       Transamiga CreateFileList V1.58
  8.                       -------------------------------
  9.  
  10.               written 1994 by Mathias Supp
  11.                               2:2476/539.0@fidoclassic
  12.                               39:173/50.0@amiganet
  13.                               s_supp@ira.uka.de
  14.  
  15.               Sysop of the Amiga Inside I : ++49(0)721-854112 (ZyX192)
  16.                                             ++49(0)721-841292 (VFC288)
  17.                                             ++49(0)721-841230 (VFC288)
  18.  
  19.                           Release : 28.01.1995
  20.  
  21.  
  22. ============================================================================
  23.  
  24. Copyright :
  25. -----------
  26.  
  27. This program can be copied freely for privat use ONLY.
  28.  
  29. It's absolutely prohibited to get money in any form for this utility.
  30.  
  31. Exceptions need my expressly permission.
  32.  
  33. Exceptions : AmiNet-CD
  34.              Fred Fish Collection
  35.  
  36. ============================================================================
  37.  
  38. Introduction :
  39. --------------
  40.  
  41. This program was created because of some missing features in Sami's
  42. Filelister (hello Sami, where's SFL3 ? ;-) )
  43.  
  44. There were no errors by testing TACFl with enforcer and mungwall.
  45.  
  46. In this version TACfl needs at least 2888 Bytes of stack.
  47.  
  48. ============================================================================
  49.  
  50. Contents of Archive :
  51. ---------------------
  52.  - TACFl            : the program
  53.  - TACFl_NC         : the program without stack/overflow/...-checking
  54.                       maybe a bit faster :-)
  55.  - TACFl.DOC        : english documentation
  56.  - TACFl.DOK        : german documentation
  57.  
  58. ============================================================================
  59.  
  60. What does it do ?
  61. -----------------
  62.  
  63. Simply creates Filelists :-)
  64.  
  65. 1. complete Filelist
  66. 2. Filelist of certain areas
  67. 3. Newfileslisting
  68. 4. Indexfiles (optionally sorted)
  69.  
  70. Areas with no files won't be listed.
  71.  
  72. ============================================================================
  73.  
  74. Parameter :
  75. -----------
  76.  
  77. LISTFILE     : path and name of the filelist you want to create
  78. CONFIGPATH   : path to your TA-configs
  79.                default : bbs:configs/
  80. DAYS         : list files which are given days old (0=file from today !)
  81.                default : list all files
  82. SINCE        : list files since given date (TA-format !!!)
  83.                default : list all files
  84. AREAFLAGS    : list areas with the given flags
  85.                default : list all areas
  86. AREARANGE    : list areas in the given arearange
  87.                format : a-b (list from area a to b)
  88.                         a-  (list from area a to the last)
  89.                         -b  (list from the first area to b)
  90.                         a   (list area a)
  91.                all formats can be used at the same time by using the ","
  92.                for example : AREARANGE=1-5,7,20-,10-13
  93.                default : list all areas
  94. ADDCR        : adds a carriage return to each line for PC lamers ;-)
  95.                default : no carriage return
  96. HEADERFILE   : file to be at the beginning of the listing
  97.                default : no headerfile
  98. BOTTOMFILE   : file to be at the end of the listing
  99.                default : no bottomfile
  100. AREASTAT     : create a statistic after each area
  101.                default : no statistic
  102. COMPLETESTAT : create a complete statistic of all areas
  103.                default : no statistic
  104. CREATEINDEX  : create an UNSORTED(!!) index for TAFreq by Thomas Boerkel
  105.                and/or Filelister by Mathias Supp for VERY HIGH searching
  106.                perfomance; sort the indexfile for use with one of the
  107.                above utilities (e.g. SORT index index.sort)
  108.                default : create NORMAL filelist
  109. SORTINDEX    : create a sorted index for TAFreq/Filelister
  110.                default : do not sort
  111. DELEMPTY     : deletes the recent created filelist if ther're no files
  112. IGNOREENV    : ignore the ENV-variable created by Filelister ?
  113.                default : do not ignore
  114.  
  115. ============================================================================
  116.  
  117. History :
  118. ---------
  119.  
  120. V1.0   05.05.94 : - first Release, which was to slow in creating a complete
  121.                     filelist
  122.                   - makes enforcer hits
  123. V1.1   09.05.94 : - faster in all operations
  124.                   - all enforcer hits removed
  125. V1.2   25.05.94 : - up to 3 times faster while creating a complete filelist
  126. V1.3   05.06.94 : - creates an unsorted index for TAFreq and Filelister
  127. V1.4   07.06.94 : - optionally create sorted and/or shorted indexes
  128.        08.06.94 : - index will be sorted at the end with quicksort
  129.                     => VERY HIGH speed improvement
  130. V1.41  10.06.94 : - optimized string comparing => half sorting time
  131. V1.42  13.06.94 : - optimized reading of Files.BBS => little faster
  132. V1.5   15.06.94 : - uses data of Filelister v0.42+ when finding his
  133.                     ENV-variable => no reading from disk necessary
  134.                   - "SHORTINDEX"-option removed because there was no
  135.                     use for the long index
  136. V1.52  25.06.94 : - TACFl now doesn't change any more the original variables
  137.                     of Filelister (thanks to Martin for reporting a con-
  138.                     fusing reaction of Filelister)
  139.                   - changed the usage of the file.cfg corresponding to
  140.                     Filelister V0.431+
  141. V1.53  06.07.94 : - because Thomas flamed me to death ( ;-) ) I changed
  142.                     the creating of the filelist when sharing memory with
  143.                     filelister : there will no more be useless spaces at
  144.                     the end of the lines
  145. V1.54  13.07.94 : - fixed a bug that causes a crash of Filelister
  146. V1.55  29.07.94 : - fixed a bug that causes a "freemem error", thanks to
  147.                     Chris for reporting
  148. V1.56  07.08.94 : - double counting of files and bytes when using "days" or
  149.                     "since" fixed
  150. V1.57  08.11.94 : - some lines of the files.bbs in the aminet-cd vol. 4
  151.                     are longer than 100 characters. In this case TACfl
  152.                     crashed sometimes. Thanks to Harald for explicit
  153.                     reporting.
  154. V1.58  28.01.95 : - added parameter "DELEMPTY" (see above)
  155.  
  156. ============================================================================
  157.  
  158. Thanks to :
  159. -----------
  160. Thomas Boerkel for the idea of binary-searching
  161. Martin Eitel   for bug-reporting
  162. Chris Qonoey   for bug-reporting
  163. Sami Radwan    for developing/supporting/... Transamiga
  164. Harald Meinzer for bug-reporting
  165.  
  166. have fun
  167.  
  168. Mathias
  169.  
  170. P.S.:   Sorry for my bad english, but I hope you understood what I mean.
  171.  
  172.  
  173. ============================= Archive contents =============================
  174.  
  175. Original  Packed Ratio    Date     Time    Name
  176. -------- ------- ----- --------- --------  -------------
  177.    35820   12896 63.9% 28-Jan-95 14:54:10  TACFl
  178.     6561    2388 63.6% 28-Jan-95 15:51:50  TACFl.DOC
  179.     7226    2613 63.8% 28-Jan-95 15:52:08  TACFl.DOK
  180.    32996   12618 61.7% 28-Jan-95 14:54:28  TACfl_NC
  181. -------- ------- ----- --------- --------
  182.    82603   30515 63.0% 29-Jan-95 12:38:38   4 files
  183.